.TH E1432_GET_GROUP_INFO 3 E1432
.SH NAME
e1432_get_group_info \- Get information about a group
.IX e1432_get_group_info(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_get_group_info(E1432ID hw, SHORTSIZ16 ID,
                                SHORTSIZ16 item, SHORTSIZ16 *answer,
                                SHORTSIZ16 size)
.cE
.SH DESCRIPTION
\fIhpe1432_getGroupInfo\fR is used to return selected information about a
channel group that has been previously created using
hpe1432_createChannelGroup().  The information is returned in an
array that must be allocated by the caller of \fIhpe1432_getGroupInfo\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIitem\fR is used to select which data is returned.  See the list below.

\fIanswer\fR is a pointer to a single answer or the start of an array of
answers.  Be sure to allocate enough space for the returing array of
data.  \fBHPE1432_GROUP_INFO_NUM_CHANNELS\fR can be used to determine how
large an array is needed.

\fIsize\fR is the maximum number of ellements allowed for the returning data.

The choices for item are;

\fBHPE1432_GROUP_INFO_NUM_MODULES\fR	Number of modules

\fBHPE1432_GROUP_INFO_LIST_MODULES\fR	List of modules

\fBHPE1432_GROUP_INFO_NUM_CHANNELS\fR	Number of channels

\fBHPE1432_GROUP_INFO_LIST_CHANNELS\fR	List of channels

\fBHPE1432_GROUP_INFO_NUM_INPUTS\fR	Number of inputs

\fBHPE1432_GROUP_INFO_LIST_INPUTS\fR	List of inputs

\fBHPE1432_GROUP_INFO_NUM_SOURCES\fR	Number of sources

\fBHPE1432_GROUP_INFO_LIST_SOURCES\fR	List of sources

\fBHPE1432_GROUP_INFO_NUM_TACHS\fR	Number of tachs

\fBHPE1432_GROUP_INFO_LIST_TACHS\fR	List of tachs


.SH "RESET VALUE"
Not applicable
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_create_channel_group
.ad


